home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-0023 / readme.med < prev    next >
Text File  |  1997-04-16  |  17KB  |  357 lines
  1.  
  2.                  FRACTALS PROGRAM IN GfA BASIC
  3.                  =============================
  4.                        *** FRZOOM ***
  5.  
  6.                         By Ian Connor
  7.                   (Version 3.3 July 1990)
  8.  
  9.  Not another Fractal program you say, Well Yes.. but wait, take a 
  10. look at this one because it will make most of the others obsolete.
  11.  
  12. There are several fractal programs available including a couple of 
  13. commercial offerings. Probably the best of these is GST FRACTALS,
  14. however, all fail in various areas because the programmers do not
  15. have a sound understanding of Fractal curves and what is needed in
  16. a program to fully study and appreciate them.
  17. I have written many fractal programs over the years ranging from
  18. 8 bit basic programs to pascal, to Machine language. Speed was 
  19. always the main driving force and with the 8 bit Atari we ended
  20. up with what we think is probably the fastest Mandelbrot program 
  21. around for those machines.
  22. With the arrival of the ST we have been going through the same
  23. process with versions in ST Basic, Megamax C , Alcyon C, Dbasic 
  24. and now compiled GfA basic. 
  25.  
  26. We Have found that compiled GfA3  as fast as C but allows 
  27. even faster development and is easier to use.
  28. Back to the subject, One of the most needed features missing on
  29. other programs was the ability to enter Real & Imaginary co-
  30. ordinates and to have these available for viewing in the program
  31. and SAVED as part of a file.
  32. Also, most are only able to produce one type of curve or suffer
  33. from scaling problems and lack of versatility.
  34. We are not a fan of some of the more recent trends where some
  35. programs do not calculate all screen points! This program DOES
  36. calculate ALL points and uses other tricks to speed execution
  37. and cut time wastage as you will soon notice.
  38. With this project I have tried to produce a very versatile
  39. program  capable  of  being  used  by  both  beginners and
  40. seasoned Fractalists (is that a word?). I think we have suceeded!
  41.  
  42.                    PROGRAM FEATURES
  43.                    ================
  44. * Optimum performance iteration loop for maximum speed.
  45. * A choice of 4 curves available for a wide variety of results.
  46. * The ability to Zoom in or out on any of the fractals.
  47. * Manual entry of parameters if required.
  48. * A Preview mode to quickly calculate and view an area.
  49. * All program features available in full screen OR preview mode.
  50. * Recontour and Histograms for optimum color banding.
  51. * Screen saves with parameters in Full screen or preview modes.
  52. * Degas screen save without parameters & with a grey border.
  53. * Calculations can be interupted before completion if required.
  54. * Recall of up to 9 previous screens complete with parameters.
  55. * Choice of 7 preset color palettes & palette editor.
  56. * Movie mode to produce/play up to 120 preview sized frames.
  57. * Joystick pan of completed screen.
  58.  
  59.  
  60.  
  61.  
  62. New features/changes since version 1.7 (for 2.3)
  63.  
  64. * Setcolor (alter the colors of pic and save palette with pic)
  65. * Autozoom allows destination co-ordinates to be entered in movie
  66.   mode. Program then smoothly zooms/pans frame by frame to the
  67.   new co-ordinates. Also now has joystick nudge (If an autozoom is 
  68.   drifting off the desired path or if you wish to nudge the preset
  69.   path towards another direction) push & hold joystick in the 
  70.   desired direction at end of each frame.
  71. * Parameters can now be set as center co-ordinates or side
  72.   co-ordinates. Also pic size can be set as a side value or
  73.   as a magnification value.
  74. * Recontour & Histogram now available in full screen mode
  75.   on a 520ST (special effect options also available)
  76. * Drive select options.      
  77. * Old file overwrite bug corrected.
  78. * File extenders now properly set by program. 
  79. * Should run from hard disk including title screen!
  80. * Joystick scroll (PAN COMPLETED FRACTAL WITH JOYSTICK !!!!)
  81. * Improved memory mamagement.
  82. * Window title line reports more information.
  83.  
  84. Changes since version 2.3 (for V2.6)
  85. * Joystick pan feature now updates iteration data buffer live! This 
  86. means Recontour & histogram data is updated with each pan scan line.
  87. Zoomframe bug on old pics loaded then zoomed is corrected.
  88. Minor histogram improvements.
  89.  
  90. Changes since version 2.6 (for 3.1)
  91. * Improved (GFA 3) floating point maths precision
  92. * Color palette rotation feature added
  93. * Option to automatically recontour completed fractals
  94. * screen flip on Play Movie for smoother frame animation. (see 520
  95.   limitations)
  96.  
  97. Changes since version 3.1  (for 3.2)
  98. * Full 520ST function restored with limitations.
  99. * Max iterations increased from 2,000 to 5,000
  100.  
  101. Changes since version 3.2 (for 3.3)
  102. * Can now save and load raw iteration data files complete
  103.   with parameters and color palette.
  104. * Improved memory management enabling greater functionability when
  105.   using a half bottle  (520ST). Improved Movie play, more frames
  106.   etc.
  107. * Addition of faster ML plotting routine (pinched from my mate in
  108.   the States, Brian Hershey (Thanks Brian).
  109. * Addition of another RECONTOUR function, the ability to Recontour
  110.   colors in a Linear OR Log fashion. 
  111.  
  112.  
  113.  
  114.                      GETTING STARTED
  115.                      ===============
  116. IMPORTANT NOTE:- Please do not add any accessories to this disk
  117. as they may not operate correctly or interfere with the operation 
  118. of this program.  This is because this program uses almost all of
  119. available memory for screen and data storage.
  120.  
  121. To become familiar with the features and operation of the 
  122. program try this:-
  123. With the program loaded and the title screen cleared to an 
  124. empty screen.
  125. Select Preview from the Options menu, Select Calculate from the
  126. options menu. (This will draw the complete mandelbrot set 
  127. in the upper left of the screen (25 seconds)).
  128. Plug in a joystick and move it in any of the 4 main directions, 
  129. note how the fractal moves one pixel or scan line and a new line 
  130. is calculated.  Use this feature to position or center your 
  131. fractal. (will work in full screen mode also!)
  132. Pick an area you'd like to zoom in on and then Select Zoom from
  133. the Options menu.
  134. Size a small zoom rectangle by pressing and holding down the
  135. left mouse button and dragging the mouse to the right and down.
  136. Release the mouse button and position the rectangle over the
  137. desired zoom area and press the mouse button again to set.
  138. Then, select Calculate from the menu again to calculate and 
  139. plot the new area.
  140. Continue the same process until you find an interesting area.
  141. Then, to produce a full screen, click on Preview again to toggle
  142. this option off.
  143. Then Select Calculate and a full screen plot will be done.
  144. When the screen is finished, experiment with - Recontour,
  145. Histogram, Screens, Color Palettes and joystick pans.
  146. Save your picture if you wish. Try loading some of the file
  147. screens on this disk or load and Play a Movie.  HAVE FUN!
  148.  
  149.  
  150.             INFORMATION ON GENERAL PROGRAM OPERATION
  151.             ========================================
  152.  
  153. **SCREEN SAVES
  154. All parameters are saved in the picture files including the fractal
  155. type, screen mode, maximum iteration level, Fractal co-ordinates and
  156. side value etc. This will enable you to re-load a picture at any 
  157. time and continue zooming etc. (Latest version also saves the color
  158. palette.)
  159.  
  160. **ZOOMING
  161. All curves can be zoomed including those interupted before completion.
  162. Zooming IN is easy, select Zoom from the menu and size & position a
  163. new zoom window rectangle. When happy with zoom frame size and position
  164. select CALCULATE to plot the new area.
  165.  
  166. NOTE ( You must be in preview mode to Zoom OUT.)
  167. Size your Zoom rectangle to a size larger than the preview frame and
  168. position over the preview frame,then select CALCULATE.. from the menu.
  169. An automatic zoom in or out is now available in movie mode. This 
  170. enables the user to automatically pan to a new set of co-ordinates 
  171. while at the same time zooming in or out of the frame. 
  172.  
  173. **MIN VALUES (eg: Min .005)
  174. These values are used in the Chaos curves only. Experiment to achieve
  175. different results. 
  176.  
  177. **RE-CONTOUR
  178. During the calculation and plotting of a fractal, the program has no 
  179. way of knowing the maximum and minimum iteration values it will 
  180. encounter, and so a quick color routine is used to set the color of
  181. a screen point. This is set to use a new color roughly every third 
  182. iteration.  Once a Fractal is complete, re contour calculates the
  183. lowest and highest iteration and divides the available colors evenly
  184. into this band, then re-plots the Fractal data.
  185. Now with Linear or Log color distribution.
  186.  
  187. **HISTOGRAM
  188. Provides you with a graph of the frequency of iterations calculated
  189. and allows you to adjust the allocation of colors. Position the
  190. mouse pointer on the color bar and press the left or right mouse
  191. buttons to change the size or position of each color block. 
  192.  
  193. **MAKE/PLAY MOVIE
  194. Available only in preview mode. Load and play one of the Fractal
  195. movies on the disk. Press and hold the mouse or press any key to
  196. interupt play.  Make your own movies.
  197.  
  198. **PARAMETERS 
  199. Used for manual input of all parameters if desired.
  200. HINT:- Try increasing the iteration limit as you zoom in , this 
  201. will slow the program down but produce more interesting and accurate
  202. results. In the curves that use the extra parameter values, try 
  203. different values for interesting results.
  204.  
  205.        
  206. NOTE(2) :- The joystick nudge feature available in movie autozoom mode
  207. will work in all 8 stick directions. When making a movie sequence using
  208. autozoom, if for example the calculated frames are drifting away from
  209. your Zoom target, hold the joystick towards the direction you wish to
  210. go. The program scans for this between frames and makes an adjustment
  211. for the next frame.   
  212.         
  213.                      MENU FUNCTION DETAILS
  214.                      =====================
  215. OPTIONS  
  216.  
  217.    Julia  set   Sets the program to calculate Julia type curves.
  218.    Mandelbrot   Sets the program to calculate Mandelbrot curves.
  219.    Chaos(1)     Sets the program to calculate and display the 
  220.                 effects of "Chaotic attractors"
  221.    Chaos(2)     Slight variation on above giving a different result.
  222.    Zoom         Zoom in or out on any frame (see hints above)
  223.    CALCULATE    Begins the calculation and plotting of the selected
  224.                 curve type.
  225.    Preview      A very useful feature! With this mode selected, the
  226.                 program calculates & plots a small version of the
  227.                 full screen in the top left part of the window.
  228.                 Saves a great deal of time when you are hunting for 
  229.                 an interesting area.  To get a full sized frame of the
  230.                 preview pic, toggle Preview off then select CALCULATE.
  231.                 You must be in preview mode to activate the Movie
  232.                 functions.
  233.    Parameters   Shows the real & imaginary co-ordinates for the 
  234.                 currently displayed frame. (either as center or edge)
  235.                 Also shows side or size of set and the iteration level
  236.                 presently being used.
  237.                 You are also able to manually enter parameters if
  238.                 desired.
  239.    
  240.    Min .05      Through to .005, .0005, & .00005    Active only when
  241.                 calculating Chaotic attractor curves. Basicly this 
  242.                 sets the lowest value the iteration loop value will be 
  243.                 allowed to drop to before an exit from the loop.
  244.  
  245.    Quit         Option to exit to desktop.
  246.  
  247.  
  248. VIEW
  249.   Sample Julia    Calculates a pre programmed Julia set frame.
  250.   Sample Mandel   As above for the Mandelbrot set.
  251.   Sample Chaos 1  As above for Chaotic attractors.
  252.   Sample Chaos 2  As above for different results.
  253.   Make movie      Activated in preview mode only. A huge
  254.                   and powerful function. With 1 meg or more
  255.                   you can create up to 120 preview sized frames
  256.                   and save them to disk for later playback.
  257.                   Smooth steps between frames can be obtained
  258.                   using Auto zoom. 
  259.                   NOTE:- When using autozoom, it is recommended
  260.                   that you zoom in or out by no more than say 15%
  261.                   from one frame to the next. E.G. to zoom in,
  262.                   set at no more than say 85% which would give
  263.                   a 15% closer view on each subsequent frame.
  264.   Play movie      Play a movie resident in memory or loaded 
  265.                   from disk. These movie files can get large, 
  266.                   50 frames uses around 90K of disk space.
  267.   Movie speed     3 movie frame playing speeds are available.
  268.   Screens         Allows up to the last 8 screens calculated
  269.                   to be displayed (also retains all parameter
  270.                   and curve type information). Very useful 
  271.                   for backtracking out of a series of zooms.
  272.                   Zoom or save any screen at any time.
  273.                   CARE:- The iteration count array only retains
  274.                   the information for the LAST screen calculated.
  275.                   (array data is used for re contour & Histograms)
  276.   Re-contour      Calculates the lowest and highest iteration 
  277.                   counts for the current screen and divides
  278.                   colors between that band and replots data to 
  279.                   screen. Also allows special effects.(If not            
  280.                   happy with results, select Screens, go back one,
  281.                   then forward to current screen to restore it.)
  282.   Histogram       Gives you a graph of the frequency of points at
  283.                   various iteration bands. Other iteration info
  284.                   is also displayed. Using the left & right mouse
  285.                   buttons, put the pointer on the color bar below
  286.                   the graph and press to alter band widths.
  287.                   (Great feature eh) Selecting the replot button
  288.                   will replot the data to screen using the new
  289.                   color bands. Special effects are also available.
  290.  
  291.  
  292. FILE
  293.   Load file       Loads a fractal file into memory complete with
  294.                   parameters used to calculate the file.  Can be
  295.                   zoomed. (Use "Parameters" to show parameters) 
  296.   Save file       Saves currently displayed fractal to disk complete
  297.                   with parameters used to calculate picture.
  298.   Delete          Can be used to delete any file type.
  299.   Autosave        For "walk away operation" File is autonamed and
  300.                   saved to disk when calculation of set is complete.
  301.   Save Degas      Saves contents of window only (no parameters) as
  302.                   a Degas file complete with grey border.
  303.   Load movie      Loads a movie frame sequence into memory.
  304.   Save movie      Saves a movie frame sequence to disk.
  305.   Load Data       Loads an Iteration count Data file from disk.
  306.   Save Data       Saves count data. (with parameters and palette)
  307.  
  308. COLOR
  309.   Palette 1       Through to palette 7 are a series of preset 
  310.                   palettes to use with your pictures. Color palettes
  311.                   are saved with the picture files.
  312.   Setcolor        Alter any of the colors as you please with the 
  313.                   advantage of seeing the effects on your display
  314.                   as you make color changes.
  315.   C/rotate        Cycles the selected color pallete. The left and
  316.                   right mouse buttons control the speed. Press
  317.                   both mouse buttons or the space bar to stop.
  318.   Help            Refers a user to these Docs.
  319.    
  320. Please write to me if any further information is required or if
  321. any bugs are located.  Ideas for improvements are welcome
  322. and we are interested in collecting other fractal programs. 
  323. The program has many features, beginners can start using it 
  324. immediately, but it will be some time before you appreciate the
  325. true power and flexibility this program offers.
  326.  
  327. The program is under continual development.  Send a disk for
  328. latest version.  Source code is available for A$15.00
  329.  
  330.   
  331. 520 ST notes:- I recently discovered with horror that V 3.1
  332. no longer ran properly on a 520 ST due to memory limitations. 
  333. These problems have been largely overcome and full 520 function is 
  334. restored although the following differences should be noted.
  335.  
  336.                 520                       1040 or larger
  337.                ----                       ----      
  338.           80 movie frames max.         120 movie frames max.
  339.   
  340.           2 screen buffers.            8 screen buffers.
  341.  
  342.                               ************
  343.  
  344.      Write to:-      Ian Connor
  345.                      C/- MACE
  346.                      P.O. Box 340
  347.                      Rosanna Vic
  348.                      Australia 3084
  349.  
  350. ====================================================================
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.